Sourced from kuva's releases.

kuva v0.2.0

[0.2.0] — 2026-05-07

Added

• DensityPlot::with_fit() — opts the density plot out of zero-anchoring so the y-axis fits the data range instead of starting at 0. Useful for precomputed curves (DensityPlot::from_curve) whose y values never reach zero. Standard KDE curves always taper to zero at the tails, so this flag has its primary effect on precomputed data. fit_y is also respected by bounds() for precomputed curves: the reported y_min now tracks the actual curve minimum rather than hardcoding 0. CLI: kuva density --fit.
• kuva::silverman_bandwidth / kuva::simple_kde / kuva::simple_kde_reflect — KDE computation functions are now part of the public API. Use these to pre-compute density curves before passing them to DensityPlot::from_curve, enabling inspection of the y range prior to setting axis bounds.
• Figure::with_row_height(row, px) — overrides the height of a single grid row (0-based). Rows without an explicit override use the default cell_height. Useful for thin legend strips, compact annotation rows, or asymmetric layouts where one row should be much taller or shorter than the others.
• Figure::with_col_width(col, px) — overrides the width of a single grid column (0-based). Columns without an explicit override use the default cell_width.
• with_figure_size + explicit rows/cols — when with_figure_size is combined with per-row or per-col overrides, the explicit sizes are subtracted first and the remaining space is divided equally among unconstrained rows/cols, so the total SVG size is still exactly honoured.
• LegendPlot auto-column reflow — when a LegendPlot is placed in a short cell (e.g. a thin legend row), the renderer now automatically increases the column count until all entries fit within the available cell height. Previously, entries overflowed the bottom of the cell.
• Figure::with_row_height(row, px) — overrides the height of a single grid row (0-based). Rows without an explicit override use the default cell_height. Useful for thin legend strips, compact annotation rows, or asymmetric layouts where one row should be much taller or shorter than the others.
• Figure::with_col_width(col, px) — overrides the width of a single grid column (0-based). Columns without an explicit override use the default cell_width.
• with_figure_size + explicit rows/cols — when with_figure_size is combined with per-row or per-col overrides, the explicit sizes are subtracted first and the remaining space is divided equally among unconstrained rows/cols, so the total SVG size is still exactly honoured.
• LegendPlot auto-column reflow — when a LegendPlot is placed in a short cell (e.g. a thin legend row), the renderer now automatically increases the column count until all entries fit within the available cell height. Previously, entries overflowed the bottom of the cell.
• LegendPlot — new plot type that renders a pure legend grid with no axes or data. Designed to occupy a dedicated figure cell so multiple data panels can share one legend without duplicating it; also usable standalone. Entries are supplied directly via LegendPlot::from_entries(entries) or built incrementally with with_entry. Column count is auto-computed from the available cell width using a conservative all-caps character-width estimate (0.68 × font_size), or fixed with with_cols(n). Supports an optional title (with_title) and background box suppression (without_box). LegendPlot and collect_legend_entries are now re-exported from kuva::prelude.
• LegendPosition::OutsideBottomColumns — places all legend entries below the plot in an auto-packed multi-column grid. Column width is estimated from the longest label at 0.68 character-width; the canvas height is automatically extended to fit every entry (no truncation). Use via Layout::with_legend_position(LegendPosition::OutsideBottomColumns).
• TextPlot — new plot type for placing formatted, word-wrapped text inside a figure cell alongside data plots. Supports an optional title, body text with inline markdown-style markup (**bold**, *italic*, __underline__), heading lines (# H1, ## H2), horizontal rules (---), paragraph spacing (blank lines), optional background fill, configurable border, text alignment (left/center/right), font size, padding, and text color. Rendered via Primitive::RichText — a new multi-span primitive that emits <tspan> children in SVG (and the raster backend's mini-SVG overlay), giving pixel-accurate inline styling. PNG and PDF inherit the SVG output automatically; the terminal backend flattens spans to plain text. Word wrapping always breaks on full words, never mid-word. Resolves #72.
• Date/time axis documentation — new reference page docs/src/reference/datetime.md with four worked examples (monthly line, scatter with dates, multi-series, hourly), covering ymd(), ymd_hms(), DateTimeAxis constructors, .with_step(), auto mode, and conversion notes for chrono, time, and std::time. examples/datetime.rs generates the accompanying SVG assets. Closes #32.
• GanttPlot — Gantt chart with horizontal task bars, optional group/phase grouping, group header background bands, per-task progress fill, milestone diamonds, "now" reference line, and smart label placement (inside bar when wide enough, to the right otherwise). Tasks with the same group share a color drawn from the category10 palette; per-task color overrides are supported. Builder API: with_task, with_task_group, with_task_group_progress, with_task_progress, with_colored_task, with_milestone, with_milestone_group, with_now_line, with_group_order, with_bar_height, with_milestone_size, with_show_labels, with_group_bg. render_gantt convenience function. CLI: kuva gantt with --label-col, --start-col, --end-col, --group-col, --progress-col, --milestone-col, --now, --bar-height, --no-labels. V2 features (dependency arrows, lane stacking) deferred to next version.
• NetworkPlot — node-edge network / graph diagram with force-directed (Fruchterman-Reingold) and circular layout algorithms. Supports edge-list and adjacency-matrix input, directed/undirected edges, self-loops, weighted edges (stroke width + opacity), per-node color/size/group, and group-based legends. CLI: kuva network.
• WafflePlot — waffle / unit chart displaying categorical proportions as a grid of colored cells. Supports square and circle cell shapes, configurable grid dimensions, fill order, empty-cell color, unit annotation, show-counts / show-percents labels, and legend. CLI: kuva waffle.
• HorizonPlot — compact multi-series time series visualization. Each series occupies a single row; the value range is divided into N equal-width bands folded onto that row with progressively darker shading. Positive and negative deviations use separate color families. Supports configurable band count, row height, baseline, value-max, and optional band-scale annotations. CLI: kuva horizon.
• PrPlot (Precision-Recall Curve) — precision-recall curve with AUC-PR computed via trapezoidal integration. Supports per-group curves from raw (score, label) predictions or pre-computed (recall, precision) points, optional optimal-F1 threshold marker, optional AUC label in legend, baseline (random classifier) line, and multi-group legend. CLI: kuva pr.
• PopulationPyramid — back-to-back horizontal bar chart for age/gender structure visualization. Supports single and multi-series (Grouped/Overlap modes), percentage normalization, value labels, per-series colors, and configurable bar width and gap. CLI: kuva pyramid.
• Native Sankey/alluvial ordering — SankeyPlot now supports ordered alluvium input via with_alluvium(), with_alluvia(), and with_axis_names(), plus optional weighted crossing reduction and neighbornet ordering through with_crossing_reduction(), with_neighbornet(), with_node_order(), and with_node_order_seed(). Node coloring can follow per-label or left-propagated alluvial coloring via with_node_coloring() / with_left_coloring(). CLI: kuva sankey --axis-col ... --node-order crossings|neighbornet --coloring label|left.
• 13 new CLI subcommands: slope, lollipop, raincloud, mosaic, waffle, pyramid, roc, pr, survival, horizon, parallel, venn, calendar — covering all previously library-only plot types.
• kuva --version / -V — kuva CLI now reports its version string. Closes #69.
• BrickPlot bladerunner stitched STRIGAR format — with_strigars now handles bladerunner's multi-candidate stitched format: | separates candidates; inter-candidate gaps render as N@ (large gap) or @:seq/1@ (small gap, light grey). Canonical-rotation normalisation operates across all candidates.
• BrickPlot::with_start_positions(iter) and BrickPlot::with_x_origin(f) — per-read genomic start coordinates for aligned repeat region display; with_x_origin sets the reference coordinate that maps to x = 0.
• StripPlot per-point markers — with_group_markers(label, values, markers) assigns a distinct marker shape per point within a strip group (triangle, square, diamond, cross, star, plus).
• Figure legend position extensions — FigureLegendPosition now includes OutsideRightMiddle, OutsideRightBottom, OutsideTopLeft, OutsideTopCenter, OutsideTopRight, OutsideBottomLeft, OutsideBottomCenter, OutsideBottomRight, OutsideLeftTop, OutsideLeftMiddle, OutsideLeftBottom in addition to the existing Right, Bottom, Custom.
• Text wrapping — long axis labels, titles, and legend items are now automatically wrapped at word boundaries when they exceed the available width.
• ColorMap extended — added Cividis, Turbo, Cubehelix, RdYlGn, BrBG, PuOr, and Spectral palettes.
• Layout::with_width_gap(px) and Layout::with_height_gap(px) — explicit per-axis gap overrides for fine-tuning panel spacing in Figure grids.
• BrickPlot figure normalisation — row heights are normalised to a consistent pixel height when BrickPlot is placed inside a Figure panel.
• JointPlot — scatter plot with marginal histograms or KDE density curves on the top and right axes; multi-group support via JointGroup; MarginalType enum (Histogram/Density); 9 tests.
• Clustermap — hierarchical clustermap: heatmap with UPGMA-computed row and column dendrograms rendered as PhyloTree panels; ClustermapNorm for row/column z-score normalisation; AnnotationTrack for categorical bar annotations on rows or columns; pre-supplied PhyloTree override; colorbar. Closes #59.
• Heatmap row/column reordering — Heatmap::with_y_categories(order) permutes data rows so the first label renders at the top; with_x_categories(order) permutes columns. Order is expressed as label names. Closes #59.
• Layout::with_equal_aspect() — expands the shorter axis so that 1 data unit spans the same number of pixels on both x and y; no-op on log axes and pixel-space plots (polar, ternary, pie, chord, etc.). Guards against degenerate zero-width ranges. 5 tests. Closes #58.
• CLI --y multi-column — kuva scatter and kuva line now accept comma-separated column names or indices for --y (e.g. --y A,B,C); one auto-colored series is created per column; conflicts with --color-by. Legend labels use column header names when present, otherwise col_N. Partially closes #57.
• RocPlot — ROC curve with trapezoidal AUC, DeLong 95% CI bands, partial AUC, Youden's J optimal-threshold marker, AUC label in legend, and diagonal chance-level reference line; 14 tests. CLI: kuva roc.
• LollipopPlot — lollipop / mutation landscape chart: vertical stems with dot markers, per-point labels and colors, and protein-domain annotation rectangles via LollipopDomain; 15 tests. CLI: kuva lollipop.
• SurvivalPlot (Kaplan–Meier) — right-continuous step-function survival curve with Greenwood 95% CI bands, censoring tick marks, multi-group legend, and optional log-rank p-value annotation; 12 tests. CLI: kuva survival.
• RaincloudPlot — half-violin KDE cloud + box-and-whisker + jittered rain in a single panel; per-group colors; with_flip, with_bandwidth_scale, and with_cloud/with_box/with_rain toggles; 11 tests. CLI: kuva raincloud.
• SlopePlot (dumbbell plot) — paired before/after values connected by a line; direction-based coloring (up/down/flat); outer-anchored, collision-safe labels; configurable dot size and group colors; 13 tests. CLI: kuva slope.
• VennPlot — Venn diagram for 2–4 sets; classic and proportional circle/ellipse layouts; raw element or pre-computed size input; region labels with per-set colored indicator dots; hybrid inline + leader-line labeling with march-outward anchor placement; with_leader_lines, with_set_indicators, with_proportional, with_loss; 21 tests. CLI: kuva venn.
• ParallelPlot — parallel coordinates chart; per-axis independent normalisation; optional shared scale; polyline + cubic-Bézier rendering; group colors + legend; optional mean overlay; axis inversion with orange indicator; adaptive h_inset / tick font scaling to prevent label collision on dense axes; 16 tests. CLI: kuva parallel.
• MosaicPlot — Marimekko / mosaic chart: variable-width columns proportional to column totals with stacked segments; custom y-axis (0–100%); cell percent and/or raw value labels; with_normalize, with_gap, with_col_order, with_row_order, with_group_colors; 12 tests. CLI: kuva mosaic.
• StreamgraphPlot — stream graph with Catmull-Rom smooth curves; StreamBaseline (Wiggle/Symmetric/Zero); StreamOrder (InsideOut/ByTotal/Original); inter-stream strokes; inline stream labels at the widest point; 100% normalisation mode; 20 tests.

... (truncated)

Sourced from kuva's changelog.

[0.2.0] — 2026-05-07

Added

• DensityPlot::with_fit() — opts the density plot out of zero-anchoring so the y-axis fits the data range instead of starting at 0. Useful for precomputed curves (DensityPlot::from_curve) whose y values never reach zero. Standard KDE curves always taper to zero at the tails, so this flag has its primary effect on precomputed data. fit_y is also respected by bounds() for precomputed curves: the reported y_min now tracks the actual curve minimum rather than hardcoding 0. CLI: kuva density --fit.
• kuva::silverman_bandwidth / kuva::simple_kde / kuva::simple_kde_reflect — KDE computation functions are now part of the public API. Use these to pre-compute density curves before passing them to DensityPlot::from_curve, enabling inspection of the y range prior to setting axis bounds.
• Figure::with_row_height(row, px) — overrides the height of a single grid row (0-based). Rows without an explicit override use the default cell_height. Useful for thin legend strips, compact annotation rows, or asymmetric layouts where one row should be much taller or shorter than the others.
• Figure::with_col_width(col, px) — overrides the width of a single grid column (0-based). Columns without an explicit override use the default cell_width.
• with_figure_size + explicit rows/cols — when with_figure_size is combined with per-row or per-col overrides, the explicit sizes are subtracted first and the remaining space is divided equally among unconstrained rows/cols, so the total SVG size is still exactly honoured.
• LegendPlot auto-column reflow — when a LegendPlot is placed in a short cell (e.g. a thin legend row), the renderer now automatically increases the column count until all entries fit within the available cell height. Previously, entries overflowed the bottom of the cell.

Added

• Figure::with_row_height(row, px) — overrides the height of a single grid row (0-based). Rows without an explicit override use the default cell_height. Useful for thin legend strips, compact annotation rows, or asymmetric layouts where one row should be much taller or shorter than the others.

• Figure::with_col_width(col, px) — overrides the width of a single grid column (0-based). Columns without an explicit override use the default cell_width.

• with_figure_size + explicit rows/cols — when with_figure_size is combined with per-row or per-col overrides, the explicit sizes are subtracted first and the remaining space is divided equally among unconstrained rows/cols, so the total SVG size is still exactly honoured.

• LegendPlot auto-column reflow — when a LegendPlot is placed in a short cell (e.g. a thin legend row), the renderer now automatically increases the column count until all entries fit within the available cell height. Previously, entries overflowed the bottom of the cell.

• LegendPlot — new plot type that renders a pure legend grid with no axes or data. Designed to occupy a dedicated figure cell so multiple data panels can share one legend without duplicating it; also usable standalone. Entries are supplied directly via LegendPlot::from_entries(entries) or built incrementally with with_entry. Column count is auto-computed from the available cell width using a conservative all-caps character-width estimate (0.68 × font_size), or fixed with with_cols(n). Supports an optional title (with_title) and background box suppression (without_box). LegendPlot and collect_legend_entries are now re-exported from kuva::prelude.

• LegendPosition::OutsideBottomColumns — places all legend entries below the plot in an auto-packed multi-column grid. Column width is estimated from the longest label at 0.68 character-width; the canvas height is automatically extended to fit every entry (no truncation). Use via Layout::with_legend_position(LegendPosition::OutsideBottomColumns).

• TextPlot — new plot type for placing formatted, word-wrapped text inside a figure cell alongside data plots. Supports an optional title, body text with inline markdown-style markup (**bold**, *italic*, __underline__), heading lines (# H1, ## H2), horizontal rules (---), paragraph spacing (blank lines), optional background fill, configurable border, text alignment (left/center/right), font size, padding, and text color. Rendered via Primitive::RichText — a new multi-span primitive that emits <tspan> children in SVG (and the raster backend's mini-SVG overlay), giving pixel-accurate inline styling. PNG and PDF inherit the SVG output automatically; the terminal backend flattens spans to plain text. Word wrapping always breaks on full words, never mid-word. Resolves #72.

• Date/time axis documentation — new reference page docs/src/reference/datetime.md with four worked examples (monthly line, scatter with dates, multi-series, hourly), covering ymd(), ymd_hms(), DateTimeAxis constructors, .with_step(), auto mode, and conversion notes for chrono, time, and std::time. examples/datetime.rs generates the accompanying SVG assets. Closes #32.

• GanttPlot — Gantt chart with horizontal task bars, optional group/phase grouping, group header background bands, per-task progress fill, milestone diamonds, "now" reference line, and smart label placement (inside bar when wide enough, to the right otherwise). Tasks with the same group share a color drawn from the category10 palette; per-task color overrides are supported. Builder API: with_task, with_task_group, with_task_group_progress, with_task_progress, with_colored_task, with_milestone, with_milestone_group, with_now_line, with_group_order, with_bar_height, with_milestone_size, with_show_labels, with_group_bg. render_gantt convenience function. CLI: kuva gantt with --label-col, --start-col, --end-col, --group-col, --progress-col, --milestone-col, --now, --bar-height, --no-labels. V2 features (dependency arrows, lane stacking) deferred to next version.

• NetworkPlot — node-edge network / graph diagram with force-directed (Fruchterman-Reingold) and circular layout algorithms. Supports edge-list and adjacency-matrix input, directed/undirected edges, self-loops, weighted edges (stroke width + opacity), per-node color/size/group, and group-based legends. CLI: kuva network.

• WafflePlot — waffle / unit chart displaying categorical proportions as a grid of colored cells. Supports square and circle cell shapes, configurable grid dimensions, fill order, empty-cell color, unit annotation, show-counts / show-percents labels, and legend. CLI: kuva waffle.

• HorizonPlot — compact multi-series time series visualization. Each series occupies a single row; the value range is divided into N equal-width bands folded onto that row with progressively darker shading. Positive and negative deviations use separate color families. Supports configurable band count, row height, baseline, value-max, and optional band-scale annotations. CLI: kuva horizon.

• PrPlot (Precision-Recall Curve) — precision-recall curve with AUC-PR computed via trapezoidal integration. Supports per-group curves from raw (score, label) predictions or pre-computed (recall, precision) points, optional optimal-F1 threshold marker, optional AUC label in legend, baseline (random classifier) line, and multi-group legend. CLI: kuva pr.

• PopulationPyramid — back-to-back horizontal bar chart for age/gender structure visualization. Supports single and multi-series (Grouped/Overlap modes), percentage normalization, value labels, per-series colors, and configurable bar width and gap. CLI: kuva pyramid.

• Native Sankey/alluvial ordering — SankeyPlot now supports ordered alluvium input via with_alluvium(), with_alluvia(), and with_axis_names(), plus optional weighted crossing reduction and neighbornet ordering through with_crossing_reduction(), with_neighbornet(), with_node_order(), and with_node_order_seed(). Node coloring can follow per-label or left-propagated alluvial coloring via with_node_coloring() / with_left_coloring(). CLI: kuva sankey --axis-col ... --node-order crossings|neighbornet --coloring label|left.

• 13 new CLI subcommands: slope, lollipop, raincloud, mosaic, waffle, pyramid, roc, pr, survival, horizon, parallel, venn, calendar — covering all previously library-only plot types.

• kuva --version / -V — kuva CLI now reports its version string. Closes #69.

• BrickPlot bladerunner stitched STRIGAR format — with_strigars now handles bladerunner's multi-candidate stitched format: | separates candidates; inter-candidate gaps render as N@ (large gap) or @:seq/1@ (small gap, light grey). Canonical-rotation normalisation operates across all candidates.

• BrickPlot::with_start_positions(iter) and BrickPlot::with_x_origin(f) — per-read genomic start coordinates for aligned repeat region display; with_x_origin sets the reference coordinate that maps to x = 0.

• StripPlot per-point markers — with_group_markers(label, values, markers) assigns a distinct marker shape per point within a strip group (triangle, square, diamond, cross, star, plus).

• Figure legend position extensions — FigureLegendPosition now includes OutsideRightMiddle, OutsideRightBottom, OutsideTopLeft, OutsideTopCenter, OutsideTopRight, OutsideBottomLeft, OutsideBottomCenter, OutsideBottomRight, OutsideLeftTop, OutsideLeftMiddle, OutsideLeftBottom in addition to the existing Right, Bottom, Custom.

• Text wrapping — long axis labels, titles, and legend items are now automatically wrapped at word boundaries when they exceed the available width.

• ColorMap extended — added Cividis, Turbo, Cubehelix, RdYlGn, BrBG, PuOr, and Spectral palettes.

• Layout::with_width_gap(px) and Layout::with_height_gap(px) — explicit per-axis gap overrides for fine-tuning panel spacing in Figure grids.

• BrickPlot figure normalisation — row heights are normalised to a consistent pixel height when BrickPlot is placed inside a Figure panel.

• JointPlot — scatter plot with marginal histograms or KDE density curves on the top and right axes; multi-group support via JointGroup; MarginalType enum (Histogram/Density); 9 tests.

• Clustermap — hierarchical clustermap: heatmap with UPGMA-computed row and column dendrograms rendered as PhyloTree panels; ClustermapNorm for row/column z-score normalisation; AnnotationTrack for categorical bar annotations on rows or columns; pre-supplied PhyloTree override; colorbar. Closes #59.

• Heatmap row/column reordering — Heatmap::with_y_categories(order) permutes data rows so the first label renders at the top; with_x_categories(order) permutes columns. Order is expressed as label names. Closes #59.

• Layout::with_equal_aspect() — expands the shorter axis so that 1 data unit spans the same number of pixels on both x and y; no-op on log axes and pixel-space plots (polar, ternary, pie, chord, etc.). Guards against degenerate zero-width ranges. 5 tests. Closes #58.

• CLI --y multi-column — kuva scatter and kuva line now accept comma-separated column names or indices for --y (e.g. --y A,B,C); one auto-colored series is created per column; conflicts with --color-by. Legend labels use column header names when present, otherwise col_N. Partially closes #57.

• RocPlot — ROC curve with trapezoidal AUC, DeLong 95% CI bands, partial AUC, Youden's J optimal-threshold marker, AUC label in legend, and diagonal chance-level reference line; 14 tests. CLI: kuva roc.

• LollipopPlot — lollipop / mutation landscape chart: vertical stems with dot markers, per-point labels and colors, and protein-domain annotation rectangles via LollipopDomain; 15 tests. CLI: kuva lollipop.

• SurvivalPlot (Kaplan–Meier) — right-continuous step-function survival curve with Greenwood 95% CI bands, censoring tick marks, multi-group legend, and optional log-rank p-value annotation; 12 tests. CLI: kuva survival.

• RaincloudPlot — half-violin KDE cloud + box-and-whisker + jittered rain in a single panel; per-group colors; with_flip, with_bandwidth_scale, and with_cloud/with_box/with_rain toggles; 11 tests. CLI: kuva raincloud.

• SlopePlot (dumbbell plot) — paired before/after values connected by a line; direction-based coloring (up/down/flat); outer-anchored, collision-safe labels; configurable dot size and group colors; 13 tests. CLI: kuva slope.

... (truncated)

• 300305e dev->main merge for release v0.2.0 (#76)
• be70117 fix fmt
• c76882f update docs and bump to v0.2.0
• e70ecd8 eppose kde functions and add fit_y with tests #75
• cd9b846 export kde functions for density plot #75
• 2f7b743 cargo fmt fixes
• f9be2fa anchor y zero flag #75
• 6ae08eb Add csv lib for cli to address #74
• 11c73c8 fill in missing docs
• f6e139c Compress bundled DejaVu Sans font to shrink crate size (#73)
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)